home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / Graphics / ctn / CreateThumbnail.doc < prev    next >
Encoding:
Text File  |  2001-09-03  |  3.6 KB  |  153 lines
  1.  
  2.             CreateThumbnail v1.0
  3.         Created by (c) 2001 Tomasz Malerczyk
  4.         ------------------------------------
  5.  
  6.  
  7.  Disclaimer
  8.  ----------
  9.  
  10.     The program CreateThumbnail is distributed "as is"
  11.     and the author will not be responsible for any
  12.     damage on either you, your computer or any data.
  13.     This program is used entirely on YOUR own risk. 
  14.  
  15.  Distribution
  16.  ------------
  17.  
  18.     CreateThumbnail is released as MAILWARE.
  19.     It may be used, copied and spread as long as you want
  20.     without taking any charge for it.
  21.     But if you use it frequently you must send e-mail to author.
  22.  
  23.  Copyrights
  24.  ----------
  25.  
  26.     CreateThumbnail v1.0
  27.     Copyright (c) 2001 by Tomasz Malerczyk
  28.  
  29.     jpeg.library and imageprocess.library 
  30.     Copyright (c) 1999-2001 Paul Huxham
  31.     
  32.  Introduction
  33.  ------------
  34.  
  35.     CreateThumbnail is a small utility for creating thumbnails
  36.     from JPEG images.
  37.  
  38.     It is very similiar to MakeThumbNail from OpalVision but
  39.     uses a little diffirent way to store thumbnails.
  40.  
  41.     Both, CreateThumbnail and MakeThumbNail store thumbnails
  42.     INSIDE the source JPEG image. It means that no additional
  43.     files (images) are created or writed to disk.
  44.     The thumbnails are stored in a friendly way so the image
  45.     containg thumbnail is still viewable with any JPEG viewer.
  46.     (it seems that not many people knows that JPEG image
  47.     can contain thumbnail)
  48.  
  49.     Ofourse nothing comes for free and files with thumbnails
  50.     are a little larger than without thumbnail.
  51.  
  52.     MakeThumbNail use feature called Embedded Thumbnail which 
  53.     can only use RGB data (3 bytes per pixels).
  54.     It is easy to guess that for 80x80 thumbnail the source
  55.     file will be 80*80*3 = 19200 bytes larger.
  56.  
  57.     CreateThumbnail use JPEG Extension Segment designed
  58.     just for thumbnails. It can hold 3 types of data:
  59.  
  60.     - 8 bit paletted thumbnails (usually greyscaled)
  61.     - RGB thumbnails (similar to that created by MakeThumbNail)
  62.     - JPEG compressed thumbnails
  63.  
  64.     The same 80x80 JPEG compressed thumbnail will have about
  65.     4-6 Kbytes.
  66.  
  67.     As you can see there is a difirence.
  68.  
  69.     Furthermore, viewing such small JPEGs is fast enough
  70.     even on slow machines.
  71.  
  72.  REQUIREMENTS
  73.  ------------
  74.  
  75.      The program was been created on OS3.0 but it should
  76.      work with OS2.0 and up.
  77.  
  78.     You will need:
  79.  
  80.     - jpeg.library v6.2
  81.     - imageprocess.library v1.0
  82.  
  83.     - some free memory
  84.     - some free hard-disk space
  85.  
  86.  HOW TO USE ?
  87.  ------------
  88.  
  89.     CreateThumbnail can bo launched only from CLI.
  90.  
  91.     You can abort it by pressing Ctrl+C.
  92.     (the program will exit after current image is done)
  93.     
  94.     The template is:
  95.  
  96.     SOURCE/A,DESTINATION/A,QUIET/S,ASYNCIO/S,FORCESCALE/N,
  97.     LARGETHUMB/S
  98.  
  99.     - SOURCE/A    
  100.         Source file or directory to load from.
  101.         (this option is required)
  102.  
  103.     - DESTINATION/A
  104.         Destination file or directory. It must
  105.         be diffirent than source.
  106.         (this option is required)
  107.  
  108.     - QUIET/S
  109.         Do not show any infos.
  110.  
  111.     - ASYNCIO/S
  112.         jpeg.library will use asyncio.library for
  113.         disk I/O
  114.  
  115.     - FORCESCALE/N
  116.         Available values are: 1,2,4,8
  117.         This tells jpeg.library to use selected 
  118.         scale factor. 
  119.  
  120.         It is useful for big images.
  121.  
  122.         jpeg.library will magicaly skip some image
  123.         data while decoding (the greater value
  124.         the more data are skiped) resulting in
  125.         smaller decoded image, smaller memory
  126.         usage and finally faster decoding.
  127.  
  128.         It is also faster to produce thumbnail from
  129.         smaller image.
  130.  
  131.         Usualy you will use values from 1 to 4 but
  132.         for really big images 8 is recommended.
  133.  
  134.     - LARGETHUMB/S
  135.         Forces CreateThumbnail to produce 80x80 instead
  136.         of 64x64 thumbnails.
  137.  
  138.         (always the widest side of source image will
  139.         be considered)
  140.                         
  141.  CONTACT AUTHOR        
  142.  --------------
  143.  
  144.     Bug reports, comments and pretty girls phone numbers
  145.     send to:
  146.  
  147.     Tomasz Malerczyk - vepar@friko6.onet.pl
  148.  
  149.     As always note for Enforcer owners. Please send
  150.     enforcer hit reports.
  151.  
  152.  
  153.